More docs provided by Owen Taylor.

2005-06-11  Matthias Clasen  <mclasen@redhat.com>

	* gtk/gtkwidget.c (gtk_widget_set_app_paintable): More docs
	provided by Owen Taylor.

diff --git a/ChangeLog b/ChangeLog
index f07b8112b215e9cf7edbc8867a67092a87a1c4a5..0e051a47d05fd14d19a46eb5384b8f78c0ba1298 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,8 @@
 2005-06-11  Matthias Clasen  <mclasen@redhat.com>
 
+       * gtk/gtkwidget.c (gtk_widget_set_app_paintable): More docs
+       provided by Owen Taylor.
+
        * gtk/gtk.symbols: 
        * gtk/gtkiconview.h: 
        * gtk/gtkiconview.c (gtk_icon_view_get_visible_range): 

diff --git a/ChangeLog.pre-2-10 b/ChangeLog.pre-2-10
index f07b8112b215e9cf7edbc8867a67092a87a1c4a5..0e051a47d05fd14d19a46eb5384b8f78c0ba1298 100644 (file)
--- a/ChangeLog.pre-2-10
+++ b/ChangeLog.pre-2-10
@@ -1,5 +1,8 @@
 2005-06-11  Matthias Clasen  <mclasen@redhat.com>
 
+       * gtk/gtkwidget.c (gtk_widget_set_app_paintable): More docs
+       provided by Owen Taylor.
+
        * gtk/gtk.symbols: 
        * gtk/gtkiconview.h: 
        * gtk/gtkiconview.c (gtk_icon_view_get_visible_range): 

diff --git a/ChangeLog.pre-2-8 b/ChangeLog.pre-2-8
index f07b8112b215e9cf7edbc8867a67092a87a1c4a5..0e051a47d05fd14d19a46eb5384b8f78c0ba1298 100644 (file)
--- a/ChangeLog.pre-2-8
+++ b/ChangeLog.pre-2-8
@@ -1,5 +1,8 @@
 2005-06-11  Matthias Clasen  <mclasen@redhat.com>
 
+       * gtk/gtkwidget.c (gtk_widget_set_app_paintable): More docs
+       provided by Owen Taylor.
+
        * gtk/gtk.symbols: 
        * gtk/gtkiconview.h: 
        * gtk/gtkiconview.c (gtk_icon_view_get_visible_range): 

diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c
index d61046eb097b58b47ca08da6b7006e8b4233fffa..2006789230e32579de948e8110b54390b14af548 100644 (file)
--- a/gtk/gtkwidget.c
+++ b/gtk/gtkwidget.c
@@ -4270,9 +4270,15 @@ gtk_widget_set_state (GtkWidget           *widget,
  * @widget: a #GtkWidget
  * @app_paintable: %TRUE if the application will paint on the widget
  *
- * Sets the app-paintable property to indicate to the widget that the
- * application intends to paint directly on the widget.
- *
+ * Sets whether the application intends to draw on the widget in
+ * an ::expose-event handler. 
+ *
+ * This is a hint to the widget and does not affect the behavior of 
+ * the GTK+ core; many widgets ignore this flag entirely. For widgets 
+ * that do pay attention to the flag, such as #GtkEventBox and #GtkWindow, 
+ * the effect is to suppress default themed drawing of the widget's 
+ * background. (Children of the widget will still be drawn.) The application 
+ * is then entirely responsible for drawing the widget background.
  **/
 void
 gtk_widget_set_app_paintable (GtkWidget *widget,